home *** CD-ROM | disk | FTP | other *** search
/ Computer Music 2004 January / Computer Music Magazine 68 2004.iso / pc / Software / MAC Software / Full Software / Free Effects Mac / Smartelectronix - Bram / Madshifta OS9x OSX / MadShifta readme
Encoding:
Text File  |  2002-08-13  |  4.2 KB  |  103 lines
  1. Hello and welcome to Tobybear MadShifta!
  2.  
  3. This is a VST plugin (PC only) by Tobybear (www.tobybear.de) and 
  4. Bram (www.smartelectronix.com) with full Delphi source included!
  5. It is available on Bram's truly excellent DSP source code page 
  6. www.musicdsp.org!
  7.  
  8. * This is a Mac/C++ distribution put together by Marc Poirier of 
  9. Destroy FX / Smart Electronix.  
  10. The plugins included in this distribution are for Mac OS X and 
  11. classic Mac OS (8 and 9).  
  12. The source code has been translated from Delphi to C++ by 
  13. Marc Poirier and CodeWarrior 8 project files are included.  
  14. It's actually not really a straight translation:  the editor 
  15. code was completely rewritten to use Steinberg's VSTGUI library 
  16. and Marc also changed a few little things here and there.
  17.  
  18. 1. What does it do?
  19. Well, as Bram puts it:  it is a "ultrafast and lofi pitchshifter",
  20. where the pitch of the audio is changed in realtime while the
  21. tempo is preserved.
  22. You can adjust the pitch in semitones (+/- 24 semitones) and
  23. with finetuning.  Furthermore a delay line with feedback is
  24. included and the obligatory LP/HP filter with resonance!
  25. Extra special feature:  you can use MIDI note messages to pitch
  26. the audio in realtime up or down, relatively to a root key.
  27. Furthermore a randomizer, dry/wet and output adjustments enhance
  28. the fun :-)
  29.  
  30. Note:  Our main intention here was to make clear how such an algorithm
  31. could be implemented, but the way it is presented here may not
  32. necessarily be the most performance-oriented way, so there is always
  33. room for improvement.
  34.  
  35. 2. The controls:
  36. tune:  pitch audio stream up/or down with up to 24 semitones
  37. fine:  fine tuning of the pitching
  38. root:  root note, if MIDI "Note on" messages are received the
  39. audio is pitched relatively to that note in semitones
  40. hold/back:  describes MIDI behaviour: "hold" means the relative
  41. distance between root and current note stays the current pitch,
  42. if "back" is set, it falls back to the original pitch once a "note off"
  43. is received
  44. delay:  delay amount, logarithmic scale
  45. feedback:  feedback amount of the delay
  46. cutoff:  filter cutoff
  47. resonance:  filter resonance
  48. LP/HP:  sets filter type (lowpass or highpass)
  49. dry/wet:  controls amount of processed (pitched) signal in relation
  50. to the original signal
  51. outvol:  the output volume
  52.  
  53. Click on the bear to the left to randomize all parameters
  54. Click on the note to the right to randomize only pitch
  55.  
  56. 3. Why is the source code in Delphi?
  57. Well, Delphi is still a very underestimated and underrated DSP langauge,
  58. but it is in my opinion equally powerful as C++.  Check out my other plugins
  59. at www.tobybear.de, they are all coded in Delphi too.
  60. So, first of all, to show people that it is also possible to compile
  61. VST plugins without a C++ compiler, secondly because there aren't that 
  62. much Delphi open source DSP codes floating around.
  63.  
  64. 4. What can I do with the source code?
  65. Look through it, learn from it, enhance it, add new features, but always
  66. give proper credits to both of us!  I say it again:  this plugin and its
  67. source code are mainly meant as a learning resource!
  68. Some possible extensions:
  69. - stereo mode/delay
  70. - variable buffer sizes
  71. - other filter modes
  72. - sync to host
  73. - filter/delay routing
  74. - longer delay times
  75. - LFOs
  76.  
  77. 5. What do I need to compile this plugin?
  78. CodeWarrior 8 is what Marc used to compile MadShifta.  Much older versions 
  79. can be used to compile classic Mac OS builds, and versions 7 or 6 should 
  80. also be okay for carbon builds.  
  81. You can also use Apple's Project Builder (the old classic Mac OS version) 
  82. to make classic Mac OS builds, but you won't be able to use the VSTGUI 
  83. library if you do that because that library unfortunately only works with 
  84. CodeWarrior.  
  85. The Mac OS X version of Project Builder cannot be used to compile VST 
  86. plugins because the current VST carbon spec is for CFM code-resource 
  87. binaries, and PB for OS X does not do CFM (and it never will).
  88. You can get Project Builder for free at apple.com
  89. CodeWarrior is not free, but you can find out more at metroworks.com
  90.  
  91. 6. Final words
  92. None of us is responsible if anything goes wrong with this plugin, you 
  93. use it at your own risk. Of course we tried to prevent any possible harm, 
  94. after all it is just a simple pitchshifter :-)
  95.  
  96. Contact:
  97. tobybear@web.de
  98. bram@smartelectronix.com
  99.  
  100. www.tobybear.de
  101. www.smartelectronix.com
  102. www.musicdsp.org
  103.